TcaplusDB Benchmark Tool (C++) Instructions

1. Application Scenarios

The TcaplusDB C++ Benchmark tool is mainly used for stress testing of TcaplusDB.

The TcaplusDB C++ Benchmark tool supports stress testing using fixed data sets (CSV files) as well as stress testing using rules to generate random data dynamically.

The TcaplusDB C++ Benchmark tool supports single request stress testing and multiple request mixed stress testing. Multiple request mix testing can configure the proportion of various requests. The request types supported by the current tool are:

TDR Table

  • TCAPLUS_CMD_REPLACE_REQ
  • TCAPLUS_CMD_INSERT_REQ
  • TCAPLUS_CMD_DELETE_REQ
  • TCAPLUS_CMD_GET_REQ
  • TCAPLUS_CMD_UPDATE_REQ
  • TCAPLUS_CMD_GET_RECORD_COUNT_REQ
  • TCAPLUS_CMD_INCREASE_REQ
  • TCAPLUS_CMD_GET_BY_PART_KEY_REQ
  • TCAPLUS_CMD_BATCH_GET_REQ
  • TCAPLUS_CMD_LIST_ADDAFTER_REQ
  • TCAPLUS_CMD_LIST_REPLACE_REQ
  • TCAPLUS_CMD_LIST_DELETE_REQ
  • TCAPLUS_CMD_LIST_GET_REQ
  • TCAPLUS_CMD_LIST_GETALL_REQ
  • TCAPLUS_CMD_LIST_DELETEALL_REQ

PB Table

  • TCAPLUS_CMD_PB_SET_REQ
  • TCAPLUS_CMD_PB_ADD_REQ
  • TCAPLUS_CMD_PB_DELETE_REQ
  • TCAPLUS_CMD_PB_GET_REQ
  • TCAPLUS_CMD_PB_GET_BY_PART_KEY_REQ
  • TCAPLUS_CMD_PB_GET_RECORD_COUNT_REQ
  • TCAPLUS_CMD_PB_FIELD_GET_REQ
  • TCAPLUS_CMD_PB_FIELD_SET_REQ
  • TCAPLUS_CMD_PB_FIELD_INCREASE_REQ
  • TCAPLUS_CMD_PB_LIST_ADDAFTER_REQ
  • TCAPLUS_CMD_PB_LIST_REPLACE_REQ
  • TCAPLUS_CMD_PB_LIST_GET_REQ
  • TCAPLUS_CMD_PB_LIST_GETALL_REQ
  • TCAPLUS_CMD_PB_LIST_DELETE_REQ
  • TCAPLUS_CMD_PB_LIST_DELETEALL_REQ
  • TCAPLUS_CMD_PB_LIST_DELETE_BATCH_REQ
  • TCAPLUS_CMD_PB_BATCH_GET_REQ

2. Limitations on Use

The TcaplusDB C++ Benchmark tool relies on the TcaplusDB C++ TDR SDK and TcaplusDB C++ PB SDK to read and write data.

3. Instructions

3.1. Preparations

Download the Benchmark tool. Please refer to Benchmark Tool Download for details.

3.2. Basic Test Method (Taking Linux as an example)

  1. Create a test directory (for example, the /data/ directory). 

  2. Copy the tcaplus-benchmark directory in the Benchmark tool release package to the /data/ directory.

  3. Add a test table on the TcaplusDB OMS page. For table definitions, see /data/TcaplusBenchMark/workload/tdr/generic/table_test.xml.

  4. Modify the contents of the /data/TcaplusBenchMark/workload/tdr/generic/workload.yml file. The main modification points are:

4.1. Modify database configuration and set dir_servers, app_id, app_password and zone_id

4.2. Modify the value of each records parameter and modify the file path to: /data/TcaplusBenchMark/workload/tdr/generic/test_table_rule.yml.

  1. Start the test and execute the command:
./TcaplusBenchMarkForCppApi -p database.app_id=2 -p database.zone_id=3 -p database.app_password='xxxxxxxx' -p database.dir_servers='tcp://x.x.x.x:9999' -w /data/benchMark/workload/tdr/list/workload.yml

3.3. Customized Test Method

Users can edit their own test task profiles to perform customized tests in addition to performing basic tests using the sample tables and test task profiles included in the TcaplusDB C++ Benchmark tool release package. For the test task profile setting method, refer to the TcaplusBenchMark/workload/tdr/generic/workload.yml file in the release package.

results matching ""

    No results matching ""